home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu036.dms / pu036.adf / Cursor.doc < prev    next >
Text File  |  1990-06-29  |  4KB  |  77 lines
  1.  
  2. Cursor V1.0 - A freely distributable BASIC-Compiler
  3. (c) Copyright 1990 by Jürgen Forster
  4.  
  5. This program is freeware. This means you may use it and give it to any other
  6. person, but you are not allowed to sell it except for a small copying fee.
  7.  
  8. 'Cursor' is a 3-pass compiler for BASIC-programs written with the
  9. AmigaBASIC-interpreter from Commodore. Not all BASIC-commands are
  10. implemented, but 'Cursor' is at least able to compile itsself. For a list
  11. of more or less supported BASIC-commands/functions look at the file
  12. 'Functions.asc'. Though 'Cursor' recognizes most of the AmigaBASIC-commands,
  13. many of them cause the compiled program to quit with an 'advanced feature'-
  14. errormessage.
  15.  
  16. If you want to use 'Cursor' copy the file 'Cursor' to your C:-directory and
  17. the file 'bas_runtime.library' to your LIBS:-directory. All programs
  18. compiled with 'Cursor' need this library, and as 'Cursor' itsself is written
  19. in AmigaBASIC, 'Cursor' needs the library, too. As 'Cursor' uses the four
  20. math-libraries (mathffp.library, mathtrans.library, mathieeedoubbas.library,
  21. mathieeedoubtrans.library) for floating-point operations, a compiled program
  22. always opens these four libraries (even if you only use integer variables),
  23. so you must have these four libraries in your LIBS: directory (or of course
  24. in the ROM). 'Cursor' writes one temporary file into the T: directory, so it
  25. is best to put T: into the RAM-disk.
  26.  
  27. To compile a BASIC-program start 'Cursor'. It will ask you for the name
  28. of the programm (which must have an '.bas' extension and must be in ASCII-
  29. format (use SAVE "name",A in AmigaBASIC), and will create an executable
  30. without the extension. It will report any error found and stop after one
  31. pass has been finished. ('Cursor' is not very fast at the moment, but I think
  32. I'll fix this)
  33.  
  34. About compiled programs:
  35. - all compiled programms are pure.
  36. - the CALL/SUB-...STATIC-commands pass their parameters by value and result
  37.   and not by reference (as I think AmigaBASIC does).
  38. - 'Cursor' uses buffers for input and output to files to speed I/O up.
  39. - at the moment every compiled programs allocates 200000 Bytes of memory for
  40.   the BASIC-strings, you might need one megabyte to use 'Cursor' (I'll fix
  41.   this as soon as possible).
  42. - the stack size can be very small, as the compiled programs allocate their
  43.   own memory for recursions (which are allowed)
  44. - variables in subprograms are not (like in the AmigaBASIC-interpreter)
  45.   static ones
  46. - errormessages will either be written to standard output (if it exists) or
  47.   a requester will appear
  48. - if you make 'Cursor' write the linenumbers into the executable the
  49.   linenumber will be written after any errormessage (for debuging purposes)
  50. - you can abort a compiled program almost always by using the windowclose-
  51.   gadget
  52. - programs can be started from the CLI or the workbench
  53.  
  54. The main program 'Cursor' was written in Amiga-BASIC, the library
  55. was written using the A68k-assembler (from Charlie Gibbs) and Blink (from
  56. the Software Distillery).
  57.  
  58. As I have put a lot of work into 'Cursor' and there still is a lot
  59. to be done, I want to ask you to send any sum of money to me if you like
  60. and use this program and want to encourage me to improve it. (I don't want
  61. to call 'Cursor' shareware as I don't want anyone who does not pay to have
  62. a bad conscience).
  63.  
  64. 'Cursor' is supplied as it is. I cannot be made responsible for any
  65. damage caused by 'Cursor'. Use it at your own risk!
  66.  
  67. Please send bug reports, suggestions for improvements, money or anything
  68. else to
  69.  
  70.                                             Jürgen Forster
  71.                                             Lintheide 9
  72.                                             4800 Bielefeld 17
  73.                                             West-Germany
  74.  
  75.                                             Tel.: 05208/1539
  76.  
  77.